home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / topcall.zip / TOPCALL.DOC < prev    next >
Text File  |  1992-07-26  |  12KB  |  596 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                    Top Ten User Bulletin Generation Utility
  33.  
  34.                      Copyright (c) 1992 By Mark G. Spivey
  35.  
  36.                           BBSPlus Software Utilities
  37.  
  38.                               All Rights Reserved
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.          PREAMBLE and CREDITS
  69.  
  70.          I would first  of all like  to thank Rachel,  my fiancee, who
  71.          put up  with me hanging  around in here  at all hours  of the
  72.          night without complaining! I love you!
  73.  
  74.          Second, I would  like to thank all of  the users who inspired
  75.          me to update this program after  I had decided to drop out of
  76.          FIDO net and give up, your letters got me going again.
  77.  
  78.          Third, I would  like to thank Karen Maynor  of The Dart Board
  79.          for  her help  in getting  this thing  off the  ground and my
  80.          programming started  up. I would  also like to  thank her for
  81.          use of  her board in  letting me release  my programs through
  82.          it.
  83.  
  84.          Fourth I would like to thank  my Beta Team: Norman Cox, Karen
  85.          Maynor,  Ken  Givens,  Steve  Proctor,  Jim  Thompson, Robert
  86.          Garbutt.
  87.  
  88.          There  will be  several other  program names  mentioned in my
  89.          documentation or other areas that are the respective programs
  90.          of their authors and are no way related to mine.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.          LICENSING INFORMATION
  135.  
  136.          "TOPCALL"   refers   to   the   executable   program(s)   and
  137.          documentation  contained in  the TOPCALL  archive released by
  138.          BBSPlus Software (Shareware Version).
  139.  
  140.          1. TOPCALL  is the copywritten material  of BBSPlus Software.
  141.          It may only be used in accordance with the conditions set out
  142.          in this license agreement.
  143.  
  144.          2. You may use TOPCALL for a period of three weeks on a trial
  145.          basis  in  order  to  determine  it's  suitability  for  your
  146.          particular application.  After this period  you MUST register
  147.          each copy of TOPCALL  that you run simultaneously. Multi-line
  148.          installations that  share a common message  and file base AND
  149.          have the same name need only register one copy.
  150.  
  151.          3. Registration  entitles you to  use TOPCALL and  any future
  152.          versions of TOPCALL  for as long as you  wish, subject to any
  153.          special licensing conditions attached to future versions. For
  154.          details on  the registration procedure, refer  to the section
  155.          in this document "HOW TO REGISTER".
  156.  
  157.          4. BBSPlus Software is in  no way obligated to provide future
  158.          versions of, or support for, TOPCALL.
  159.  
  160.          5. Site and Group registrations  are available, and are dealt
  161.          with on a case by case basis.
  162.  
  163.          6. You may not modify or otherwise reverse-engineer TOPCALL.
  164.  
  165.          7. You are encouraged to  distribute TOPCALL provided that no
  166.          fee   is  charged   for  its   distribution,  and   that  the
  167.          distribution archive is not modified in any way. Pay Bulletin
  168.          Board Systems  may however charge  their normal fee  provided
  169.          that no additional charged for TOPCALL is levied.
  170.  
  171.          8. TOPCALL  may be included  as part of  ANY software library
  172.          which is distributed on a commercial basis (commercial = "for
  173.          money").
  174.  
  175.          9. TOPCALL may not be used in any illegal or unlawful manner.
  176.  
  177.          10. BBSPlus  Software's liability resulting from  your use or
  178.          inability to  use TOPCALL is  limited to the  amount that the
  179.          affected party has paid for it,  or in the event that TOPCALL
  180.          was  registered with  a third  party for  payment to  BBSPlus
  181.          Software,  liability  is  limited  to  the  amount  that  was
  182.          received by BBSPlus Software from that third party.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.          HOW TO REGISTER
  201.  
  202.          Shareware version:
  203.  
  204.          Systems that qualify for this category must be physically run
  205.          from a noncommercial OR commercial site.
  206.  
  207.          Print or reproduce  the registration form at the  end of this
  208.          section  and send  it with  your registration  payment to the
  209.          following address:
  210.  
  211.          Mark Spivey            Cost:  $5.00 Each Individual Utility
  212.          Registration/TOPCALL
  213.          2900 Colerain Rd.  #938
  214.          St. Mary's,  GA  31558
  215.          USA
  216.  
  217.          * You MUST fill out the  registration form correctly in order
  218.          for your registration to be processed.
  219.  
  220.          * Check and money orders should be made payable to the person
  221.          listed above.
  222.  
  223.          * Please  include your  FIDONET address  or a  self addressed
  224.          stamped  envelope  so  that  receipt  of  your payment may be
  225.          acknowledged.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                   *** TOPCALL REGISTRATION FORM ***
  267.  
  268.          Your Name ________________________________________________
  269.  
  270.          Your BBS Name ____________________________________________
  271.  
  272.          Network Address (net name too) ___________________________
  273.  
  274.          Primary BBS # and Baud ___________________________________
  275.  
  276.          Voice Telephone # ________________________________________
  277.  
  278.          Hours of Operation _______________________________________
  279.  
  280.          Postal Address :
  281.  
  282.          __________________________________________________________
  283.  
  284.          __________________________________________________________
  285.  
  286.          __________________________________________________________
  287.  
  288.          Version Registering BBS_PAK -1.
  289.  
  290.          Registration Amount enclosed _____, for ____ copy(s).
  291.  
  292.          What do you like about TOPCALL? ___________________________
  293.  
  294.          ___________________________________________________________
  295.  
  296.          ___________________________________________________________
  297.  
  298.          What suggestions would you have for TOPCALL? ______________
  299.  
  300.          ___________________________________________________________
  301.  
  302.          ___________________________________________________________
  303.  
  304.          What BBS program do you use? ______________________________
  305.  
  306.          What Mailer do you use? ___________________________________
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.          PRODUCT SUPPORT
  333.  
  334.          You can always get the latest version of TOPCALL from my BBS,
  335.          Online  Information  Systems,  912-882-8667.  I  will support
  336.          anyone  100%  via  this  system  or  netmail whether you have
  337.          registered or not.  I carry an echo for  support which may be
  338.          placed on the backbone one day which will make it easier. The
  339.          reason that I will  support registered users AND unregistered
  340.          users is that  I have wanted to use a  program and the author
  341.          felt I should register it before  he would help me. This made
  342.          me delete the program and refuse to use it ever again.
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.          BUG REPORTS
  399.  
  400.          With all software, there are going to be a few bugs that were
  401.          not found during the BETA  testing period. This is normal and
  402.          is  much easier  to fix  with  the  help of  the user  of the
  403.          software.  If you  notice anything  weird happening  and have
  404.          found it  to be my programs  fault, I would appreciate  it if
  405.          you let me know. I will see if the bug exists and if you have
  406.          in  fact  found  a  bug, (and are the first to report it)
  407.          I  will  grant  you a FREE version.
  408.  
  409.          Hopefully this  will give more  incentive to helping  me find
  410.          problems in my software. You may reach me via FIDO netmail at
  411.          address 1:3640/13. This will allow  a much faster response to
  412.          the problem. If you prefer US MAIL you can reach me at:
  413.  
  414.          2900 Colerain Rd. #938 St. Mary's, Ga 31558
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.         ---------------------[ TOPCALL.EXE ]----------------------
  465.  
  466.          PURPOSE
  467.  
  468.          This program will generate (on request only) a top ten caller
  469.          list in ANSI and ASCII  format for the best callers, posters,
  470.          uploaders, downloaders, uploaders in megs, and downloaders in
  471.          megs. Why another one? Well, I used another program and I did
  472.          not like the way that did not allow me to choose which one to
  473.          create and I had to delete  them after running it and that it
  474.          was quite slow. This program can be run after each caller and
  475.          only  takes about  2 seconds  on my  SLOW 286/6. Another fine
  476.          feature is that you specify where the files go and their name
  477.          in the configuration file and you  can do this for each node.
  478.          Colors are also definable by  the SysOp via the Configuration
  479.          file.
  480.  
  481.          CONFIGURATION
  482.  
  483.          Single Line Users:
  484.  
  485.          Edit the configuration file and place it in the directory you
  486.          intend to execute it.
  487.  
  488.          Multi Line  Users:
  489.  
  490.          Place  the configuration file into each node directory for
  491.          your BBS.
  492.  
  493.          Line 1 - Name of your BBS as you would like it to appear in
  494.          the TOP CALL files.  Cannot exceed 38 chars.
  495.  
  496.          Line 2 - The full path to your BBS's  users file including a
  497.          trailing backslash. (eg. C:\RA\MESSAGE\)
  498.  
  499.          Line 3 - Path and  filename  WITHOUT an  extension of TOP 10
  500.          CALLERS.
  501.  
  502.          Line 4 - Path and filename of TOP 10 POSTERS.
  503.  
  504.          Line 5 - Path and filename of TOP 10 UPLOADERS IN FILES.
  505.  
  506.          Line 6 - Path and filename of TOP 10 DOWNLOADERS IN FILES.
  507.  
  508.          Line 7 - Path and filename of TOP 10 UPLOADERS IN MEGS.
  509.  
  510.          Line 8 - Path and filename of TOP 10 DOWNLOADERS IN MEGS.
  511.  
  512.          Color Chart
  513.               1 - Red              9 - Light Red
  514.               2 - Green           10 - Light Green
  515.               3 - Brown           11 - Yellow
  516.               4 - Blue            12 - Light Blue
  517.               5 - Magenta         13 - Light Magenta
  518.               6 - Cyan            14 - Light Cyan
  519.               7 - White           15 - Bright White
  520.               8 - Grey
  521.  
  522.  
  523.                Color 1 ->    Created by TOPCALL by Mark G. Spivey
  524.                Color 2 ->           Top Ten Callers to
  525.                Color 3 ->        ONLINE INFORMATION SYSTEMS
  526.                Color 4 ->  ---------------------------------------
  527.                                          Color 6 \/
  528.                Color 5 ->  MARK SPIVEY ..............  46  <- Color 7
  529.  
  530.          Line 9 - Color1
  531.          1
  532.          Line 10 - Color2
  533.          2
  534.          Line 11 - Color3
  535.          3
  536.          Line 12 - Color4
  537.          4
  538.          Line 13 - Color5
  539.          5
  540.          Line 14 - Color6
  541.          6
  542.          Line 15 - Color7
  543.          7
  544.  
  545.          EXECUTION
  546.  
  547.          Execute  the program  just before   you load  up your  BBS or
  548.          MAILER and everything should work  fine. Make sure you do not
  549.          run this after your BBS as  the error levels will be lost and
  550.          cause problems with your batch file execution.
  551.  
  552.          Command line options are as follows, TOPCALL <number of file>
  553.          where number  of file is  the screen to  create. Here is  the
  554.          list:
  555.                 1  -  Top 10 Callers
  556.                 2  -  Top 10 Posters
  557.                 3  -  Top 10 Uploaders
  558.                 4  -  Top 10 Downloaders
  559.                 5  -  Top 10 Uploaders Megs
  560.                 6  -  Top 10 Downloaders Megs
  561.          Only one can be created at once. Example given:
  562.          TOPCALL 1 will  create the files you specified  in config for
  563.          the Top 10 callers.
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.